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Production of This Book 


This book was prepared and formatted using the IBM BookMaster document markup language. 


Second Edition (December, 1989) 


This is a major revision of, and obsoletes, LY28-1024-0. See the summary of Changes following the 
Contents for a summary of the changes made to this manual. Technical changes or additions to the 
text and illustrations are indicated by a vertical line to the left of the change. 


This edition applies to Version 3 Release 1.3 of MVS/System Product 5685-001 or 5685-002 and to all 
subsequent releases until otherwise indicated in new editions or Technical Newsletters. Changes are 
made periodically to the information herein; before using this publication in connection with the opera- 
tion of IBM systems, consult the latest /BM System/370 Bibliography, GC20-0001, for the editions that 
are applicable and current. 


References in this publication to IBM products or services do not imply that IBM intends to make these 
available in all countries in which IBM operates. References to IBM products in this document do not 
imply that functionally equivalent products may be used. The security certification of the trusted com- 
puting base that that includes the products discussed herein covers certain IBM products. Please 
contact the manufacturer of any product you may consider to be functionally equivalent for information 
on that product’s security classification. This statement does not expressly or implicitly waive any 
intellectual property right IBM may hold in any product mentioned herein. 


Publications are not stocked at the address given below. Requests for IBM publications should be 
made to your IBM representative or to the IBM branch office serving your locality. 


A form for reader’s comments is provided at the back of this publication. If the form has been 
removed, comments may be addressed to IBM Corporation, Information Development, Department D58, 
Building 921-2, PO Box 950, Poughkeepsie, NY 12602. IBM may use or distribute whatever information 
you supply in any way it believes appropriate without incurring any obligation to you. 
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PROGRAMMING INTERFACES 


This book consists entirely of diagnostic information. 
Such information should never be used as programming 
interface information. 
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About This Book 


This book will help you diagnose problems in the callable service requests compo- 
nent. Using the book, you will be able to: 


e Follow diagnostic procedures for each type of problem in the component 
e Collect and analyze data needed to diagnose the problem 


e Develop a search argument to be used for searching problem reporting data 
bases 


e Know what problem data is needed before reporting the problem to IBM 


Trademarks 
The following are trademarks of International Business Machines Corporation. 
e MVS/ESA™ 
e Hiperspace™ 
The following are registered trademarks of International Business Machines Corpo- 


ration. 


e BookMaster® 


Who Should Use This Book 


This book is for anyone who diagnoses problems that appear'to be caused by call- 
able service requests. | 
The level of detail at which this book is written assumes that the reader: 

e Understands basic system concepts and the use of system services 

e Codes in assembler language, and reads assembler and linkage editor output 

e Codes JCL statements for batch jobs and cataloged procedures 


e Understands the commonly used diagnostic tasks and aids, such as message 
logs, dumps, and the interactive problem control system (IPCS) 


e Understands the externals for callable service requests 


How to Use this Book 


Before using this book, collect the following problem data. If you do not have this 
data, see the Basics of Problem Determination book and perform its procedures. 


e The problem type, such as an abend 
e The product name 
e The component name: callable service requests 


Use this book to diagnose problems only in callable service requests. If the compo- 
nent name is not callable service requests, return to the Basics of Problem Determi- 
nation book to identify the component. Use the component diagnosis book for the 
identified component. 
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Use this book to diagnose problems in the component as follows: 

1. Identify the problem type. 

2. Collect problem data. 

3. Analyze the problem data to develop symptoms and to identify the failing code. 
4. Fix the problem, if it is in installation-provided code. | 
5 


. Develop search arguments, search problem reporting data bases, and request 
the problem fix, if the problem has been reported before. If not, continue diag- 
nosis. 


6. Collect additional problem data. 
7. Analyze the problem data to isolate the problem. 


8. Report the problem to IBM, if assistance is needed or if the problem is new. 


Where to Find More Information 


The following table lists books that contain information related to the information 
contained in this book. | 


When this book references information in other books, the shortened version of the 
book title is used. The following table shows the shortened titles, complete titles, 
and order numbers of the books that you might need while you are using this book. 


Application Development Guide MVS/ESA Application Development Guide GC28-1821 


Application Development Macro MVS/ESA Application Development Macro Reference GC28-1822 
Reference | 


Basics of Problem Determination MVS/ ESA Basics of Problem Determination 


Component Diagnosis: Data-in- MVS/ESA Component Diagnosis: Data-in-Virtual 
Virtual 


GC28-1839 
LY28-1456 


EREP User’s Guide Environmental Record Editing and Printing Program GC28-1378 
User’s Guide and Reference 

IPCS Command Reference MVS/ESA Interactive Problem Control System (IPCS) GC28-1834 
Command Reference 

IPCS User’s Guide MVS/ESA Interactive Problem Control System (IPCS) GC28-1833 


User’s Guide 


SPL: Application Development - MVS/ESA System Programming Library: Application GC28-1854 
Extended Addressability Development - Extended Addressability 


SPL: Application Development MVS/ESA System Programming Library: Application [| GC28-1852 
Guide Development Guide 

SPL: Application Development MVS/ESA System Programming Library: Application GC28-1857 
Macro Reference Development Macro Reference 


System Codes MVS/ESA Message Library: System Codes GC28-1815 


System Commands MVS/ESA Operations: System Commands GC28-1826 


System Messages MVS/ESA Message Library: System Messages, GC28-1812 and 
Volumes 1 - 2 GC28-1813 


Using Dumps and Traces MVS/ESA Diagnosis: Using Dumps and Traces LY28-1843 
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Diagnosis Library 


PLANNING: 


Planning: 
Dump and 
Trace 

Services 


GC28-1838 GC28-18532 


DIAGNOSIS: 


For Diagnostic Procedures 


Basics of 
Problem 
Determi- 
nation 


GC28-1839 | 


For Data Collection 


A”) 


SYS1.LOGREC IPCS 


Diagnosis: IPCS 
Using Error — User's Commoand 
Dumps ond Recording Guide Reference 


Troces 


LY28-1845 GC28-1833 


GC28-1845 GC28-1834} 


For Data Interpretation 


Diagnosis: Diagnosis: 
Data Areas System : 
Reference Messages 


Data Areas 
Microfiche 


GC28-1812 
& 
GC28-1813 


LY28-1043 
to 
LY28-1047 LY28-1011 GC28-1814 


LYB8S-xxxx 


For Component-Specific Information 
(To identify the component, see Basics of Problem Determination) 


Component 
Diagnosis: 


Module 
Descrip- 
tions 
LY28-xxxx LY28-xxxx LY28-1420 
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Summary of Changes 


Summary of Changes 
for LY28-1024-1 
MVS/System Product Version 3 Release 1.3 


The following summarizes the changes to the book. 
New Information: \|nformation was added to support cell pool services. 


Changed Information: Chapters 2 through 4 are renumbered to 3 through 5 and a 
new Chapter 2, “Collecting and Analyzing Problem Data for Callable Service 
Requests” is added. 


Summary of Changes 
for LY28-1024-0 
MVS/System Product Version 3 Release 1 


This book contains diagnostic information for callable service requests. This com- 
ponent provides callable interfaces to support applications and system services that 
are not directly available from high level languages. This component is new for 
MVS/System Product Version 3 Release 1. 
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Chapter 1. Diagnosing Problems in Callable Service 
Requests 


Prerequisites 


Before using this book, collect the following problem data. If you do not have 
this data, see the Basics of Problem Determination book and perform its proce- 
dures. 


e The problem type, such as an abend 
e The product name 
e The component name: callable service requests 


Use this book to diagnose problems only in callable service requests. If the 
component name is not callable service requests, return to the Basics of 
Problem Determination book to identify the component. Use the component 
diagnosis book for the identified component. 


identifying Problems 


For a problem with these symptoms: See the following: 


Abend X'019': Callable service requests abnormally terminates a caller 
with a system completion code of X'019'. This indicates a user problem. 
An accompanying reason code indicates the problem. 


Application Development Guide for 
_ callable service requests and the 
reason codes 


Component Diagnosis: Data-in- 
Virtual 


“Diagnosing an Abend Unexpected 
by Cell Pool Services” on 
page 1-5 


Note: Abend X'019' with reason code 0 occurs when you try to run a 
callable service on a lower release level system than the one it was com- 
piled on. 


Abend X'08B': A module with the prefix CSR abnormally terminates with 
a system completion code of X'08B'. | 


Abend unexpected by cell pool services: A module with the prefix CSRCP 
abnormally terminates with any code. This is an unexpected problem. 


“Diagnosing an Abend Unexpected 
by Data Windowing Services” on 
page 1-8 SO 


Abend unexpected by data windowing services: A module with the prefix 
CSR abnormally terminates with a code other than X'019' or X'08B'. 
This is an unexpected problem. 


SPL: Application Development 
Guide for an explanation of the 
return codes 


Return code from the cell pool services part of callable service requests: 
The following return codes from the cell pool services part of callable 
service requests are for information only and do not indicate a problem. 
The return codes are returned to the program issuing the call and appear 
in the caller’s parameter list and register 15. 


Return 
Code 
hex(dec) 


4 (4) 
8 (8) 
C (12) 
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For a problem with these symptoms: See the following: 


-Return code due to a user problem in the cell pool services part of call- Application Development Macro 
able service requests: The following return codes indicate a user Reference for the description of 
problem in the cell pool services part of callable service requests. The the cell pool service being exe- 
return codes are returned to the program issuing the call and appeal in cuted 
the caller’s parameter list and register 15. 


Return 
| Code 
hex(dec) 


18 (24) 
—4€ (28) 
28 (40) 
2C (44) 
30 (48) 
34 (52) 
38 (56) 
44 (68) 
48 (72) 
4C (76) 
50 (80) 
54 (84) 
58 (88) 


“Diagnosing a Return Code Due to 
a Problem in Cell Pool Services” 
on page 1-11 


- Return code due to problems in the cell pool services part of callable 
service requests: The following return codes indicate a problem in the 

cell pool services part of callable service requests. The return codes are 
returned to the program issuing the call and appear in the caller’s param- 
eter list and register 15. 


Return 
Code 
hex(dec) 


64 (100) 
68 (104) 
6C (108) 
70 (112) 
74 (116) 


Return and reason codes due to a problem in the data windowing ser- “Diagnosing a Return Code Due to 
vices part of callable service requests: The following return and reason a Problem in Data Windowing 
code combinations indicate a problem in the data windowing services Services” on page 1-13 


part of callable service requests. The return codes are returned to the 
program issuing the call and appear in the caller’s parameter list and reg- 
ister 15. The reason codes are returned to the program issuing the call 
and appear in the caller’s parameter list and register 0. _ 


Return Reason 
Code Codes 
hex(dec) (hex) 


4 (4) 00000125 
8 (8) 00000118, 00000119, 00000152 
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For a problem with these symptoms: | | See the following: 


Return and reason code due to a user problem in the data windowing ser- 
| vices part of callable service requests: The following code indicates a 

user problem, such as a problem in the program issuing the CALL state- 

ment. The return code is returned to the program issuing the call and 


appear in the caller’s parameter list and register 15. The reason code is — 


returned to the program issuing the call and appear in the caller’s param- 
eter list and register 0. 


Return Reason 
Code Code 
hex(dec) (hex) 


8 (8) 00000143 


Return code from the data windowing services part of callable requests 
due to a problem in the data-in-virtual component. The following return 
and reason code combinations from the data windowing services part of 
callable service requests indicate a problem in the data-in-virtual compo- 
nent. The return codes are returned to the program issuing the call and 
appear in the caller’s parameter list and register 15. The reason code is 
returned to the program issuing the call and appear in the caller’s param- 
eter list and register 0. 


Return Reason 
Code Code 
hex(dec) (hex) 


4 (4) hhhhhhhh 
C (12) 


Return code following an SVC 99: The following return and reason code 
from the data windowing services part of callable service requests after 
an SVC 99 indicates a problem in the allocation/unallocation component 
or in the Data Facility Product (DFP), including the storage management 
subsystem (SMS). The return code is returned to the program issuing the 
call and appears in the caller’s parameter list and register 15. The 
reason code is returned to the program issuing the call and appears in 
the caller’s parameter list and register 0. | 


Return Reason. 
Code Code 
hex(dec) (hex) 


10 (16) hhhhhhhh 
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| Diagnosing an Abend Unexpected by Cell Pool Services 


| A module with the prefix CSRCP abnormally terminates with any code. This is an 
| unexpected problem. 


| Callable service requests has no.error recovery. Any dumps will appear to be for a 
| problem in the caller or data-in-virtual. 


| If the instruction at time of error is in callable service requests, check for a problem 
| in the caller’s parameter list. 


| Another possible cause of the problem is that the application issuing the CALL for a 
| callable service did not check the return code after the CALL; then the application 

| issued another CALL to another callable service using incorrect output from the first 
| CALL. 


1. Look at the explanation for the abend code and any accompanying System Codes for an explanation | 
reason code. Take the recommended actions. of the abend code 


. Collect and analyze problem data: messages. Obtain messages System. Messages for explanations 
accompanying the abend. Look at their explanations and take any - of the messages 
recommended actions. 


. Collect problem data: the SYS1.LOGREC record or the SVC dump or EREP User’s Guide for formatting 
SYSMDUMP ABEND dump for the abend. | SYS1.LOGREC records 


¢ Format a SYS1.LOGREC record with EREP to obtain a detail edit | IPCS Command Reference for the 
report. , | subcommand: 


Format the dump with a STATUS FAILDATA subcommand or a STATUS 
VERBEXIT LOGDATA subcommand. | VERBEXIT LOGDATA 


. Identify the failing input request to callable service requests. 


To identify the request, use the explanations for the abend code 
and/or the abend reason code. Also, look in OTHER SERVICEABILITY 
INFORMATION in the STATUS FAILDATA output, VERBEXIT LOGDATA 
output, or SYS1.LOGREC report. 


. Collect information about the cell pool | Chapter 2, “Collecting and Ana- 
from the dump using the IPCS CBSTAT and CBFORMAT subcom- lyzing Problem Data for Callable 
mands. Service Requests” on page 2-1 


a ce ee ee awe ee — oom come ee ee — see ——— a ees eee memos 
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6. Search a problem reporting data base to determine if the problem Chapter 3, “Developing a Search 
was previously reported. Use the argument under SEARCH ARGU- Argument for Callable Service 
MENT ABSTRACT in: Requests” 


* SYS1.LOGREC detail edit report 
* STATUS FAILDATA output | 
* VERBEXIT LOGDATA output 


If the search finds no match, remove some symptoms or change the 
argument to the following. Search again. Continue searching for 
matches by adding, removing, and changing symptoms. 


Program identifier: PIDS/5752SCCSR 
* Load module name: RIDS/CSRCPccc#L 
* Module name: RIDS/CSRCPccc 
* System abend code: AB/SOhhh 
Abend reason code: PRCS/hhhhhhhh 


If the search finds that the problem was previously reported, request 
the problem fix. If not, continue with the next step. 


. Analyze the dump or SYS1.LOGREC report for VRA data. Find the 
heading VARIABLE RECORDING AREA (SDWAVRA) in the STATUS 
FAILDATA output, VERBEXIT LOGDATA output, or SYS1.LOGREC 

report. Note the SDWAVRA keys, lengths, and contents. 


8. Collect dump data. | Using Dumps and Traces for 


Format the dump and print it or store itin a data set. Use the fol- requesting and printing dumps 


lowing IPCS subcommands, in this order. If using IPCS interactively, IPCS Command Reference for the 
respond yes to the IPCS message that asks if summary data can be subcommands 


used by dump access. Chapter 2, “Collecting and Ana- 


lyzing Problem Data for Callable 
STATUS FAILDATA SYSTEM CPU REGISTERS DATA CONTENTION Service Requests’ 
WORKSHEET 
SUMMARY TCBERROR 
SUMMARY FORMAT 
VERBEXIT LOGDATA 
VERBEXIT SUMDUMP 
VERBEXIT TRACE 
VERBEXIT MTRACE 
CBSTAT addr STRUCTURE(CSRCPOOL) 
CBFORMAT addr STRUCTURE(CSRCPOOL) 
VERBEXIT SYMPTOM 
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9. Analyze the dump for the offset of the failing instruction into the 
module or CSECT. 


Obtain the address in the right half of the program status word (PSW) 
in the STATUS FAILDATA or VERBEXIT LOGDATA output. Subtract 
the instruction length from the PSW address to obtain the address of 
the failing instruction. If the leftmost digit in the address is greater 
than or equal to 8, subtract 8 from it. Then do one of the following: 


* If analyzing the dump interactively, use the instruction address in 
a WHERE subcommand to obtain the offset of the PSW address 
into the load module. | 


If analyzing printed output, find the instruction address: 


— In dump output from the LIST or VERBEXIT SUMDUMP sub- 
command. Look for the CSECT name eye-catcher. IBM 
CSECT eye-catchers are generally followed by an assembly 
date and a product identifier or PTF level, such as JBB3313 or 
UY01234; most eye-catchers are at the beginning of a 
module, but some are at the end. 


In a module listed for the LPAMAP or VERBEXIT NUCMAP 
subcommand.. | 


Subtract the starting address of the CSECT from the instruction 
address to obtain the offset into the CSECT. 


11. Report the problem to IBM, if assistance is needed or if the problem is 
new. Provide the following problem data: 


* Problem type: abend 

¢ Search argument 

* Dump formatted by IPCS, online or printed 

¢ Output from CBSTAT and CBFORMAT subcommands 

* SDWAVRA keys, lengths, and contents 

* Offset of the failing instruction into the module 

¢ Accompanying messages: identifiers and texts 

¢ SYS1.LOGREC report, if used 

¢ Name and level of the operating system(s) with a list of program 
temporary fixes (PTF) applied at the time of the problem and all 
installation modifications, exits, and products with other than 
Class A service 

¢ Other problem data developed while using the Basics of Problem 

Determination book . 


IPCS Command Reference for the 
subcommands: 


LIST 

LPAMAP 

STATUS 

VERBEXIT LOGDATA 
VERBEXIT NUCMAP 
VERBEXIT SUMDUMP 
WHERE 


Chapter 4, “Reporting a Problem 
to IBM” 
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Diagnosing an Abend Unexpected by Data Windowing Services 


A module with the prefix CSR abnormally terminates with a code other than X'019' 
or X'08B'. This is an unexpected problem. 


Callable service requests has no error recovery. Any dumps will appear to be for a 
problem in the caller or data-in-virtual. 


If the instruction at time of error is in callable service requests, check for a problem 
in the caller’s parameter list. 


Another possible cause of the problem is that the application issuing the CALL for a 
callable service did not check the return code after the CALL; then the application 
issued another CALL to another callable service using incorrect output from the first 
CALL. 


1. Look at the explanation for the abend code and any accompanying System Codes for an explanation 
reason code. Take the recommended actions. of the abend code 


2. Collect and analyze problem data: messages. Obtain messages System Messages for explanations 
accompanying the abend. Look at their explanations and take any of the messages 
recommended actions. 
3. Collect problem data: the S¥YS1.LOGREC record or the SVC dump or EREP User’s Guide for formatting 
SYSMDUMP ABEND dump for the abend. SYS1.LOGREC records 
¢ Format a SYS1.LOGREC record with EREP to obtain a detail edit IPCS Command Reference for the 
report. subcommand: 
¢ Format the dump with a STATUS FAILDATA subcommand or a STATUS 
VERBEXIT LOGDATA subcommand. VERBEXIT LOGDATA 


4. Identify the failing input request to callable service requests. 


To identify the request, use the explanations for the abend code 

and/or the abend reason code. Also, look in OTHER SERVICEABILITY 
INFORMATION in the STATUS FAILDATA output, VERBEXIT LOGDATA 
output, or SYS1.LOGREC report. 


Chapter 3, “Developing a Search 
Argument for Callable Service 
Requests” 


5. Search a problem reporting data base to determine if the problem 
was previously reported. Use the argument under SEARCH ARGU- 
MENT ABSTRACT in: 


* SYS1.LOGREC detail edit report 
¢ STATUS FAILDATA output 
* VERBEXIT LOGDATA output 


If the search finds no match, remove some symptoms or change the 
argument to the following. Search again. Continue searching for 
matches by adding, removing, and changing symptoms. 


* Program identifier: PIDS/5752SCCSR 
¢ Load module name: RIDS/CSRecccc#L 
¢ Module name: RIDS/CSRecccc 
¢ System abend code: AB/SOhhh 
Abend reason code: PRCS/hhhhhhhh 


If the search finds that the problem was previously reported, request 
the problem fix. If not, continue with the next step. 
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6. Analyze the dump or SYS1.LOGREC report for VRA data. Find the 
heading VARIABLE RECORDING AREA (SDWAVRA) in the STATUS 
FAILDATA output, VERBEXIT LOGDATA output, or SYS1.LOGREC 

report. Note the SDWAVRA keys, lengths, and contents. 


Using Dumps and Traces for 
requesting and printing dumps 


. Collect dump data. 


Format the dump and print it or store it in a data set. Use the fol- 
lowing IPCS subcommands, in this order. If using IPCS interactively, 
respond yes to the IPCS message that asks if summary data can be 
used by dump access. 


{PCS Command Reference for the 
subcommands 


Chapter 2, “Collecting and Ana- 
lyzing Problem Data for Callable 
_ Service Requests” 


STATUS FAILDATA SYSTEM CPU REGISTERS DATA CONTENTION 
WORKSHEET 
SUMMARY TCBERROR 
SUMMARY FORMAT 
VERBEXIT LOGDATA 
VERBEXIT SUMDUMP 
VERBEXIT TRACE 
VERBEXIT MTRACE 
VERBEXIT SYMPTOM 


IPCS Command Reference for the 
subcommands: 


LIST 


8. Analyze the dump for the offset of the failing instruction into the 
module or CSECT. 


Obtain the address in the right half of the program status word (PSW) 


in the STATUS FAILDATA or VERBEXIT LOGDATA output. Subtract LPAMAP 
the instruction length from the PSW address to obtain the address of STATUS 
the failing instruction. If the leftmost digit in the address is greater VERBEXIT LOGDATA 
than or equal to 8, subtract 8 from it. Then do one of the following: VERBEXIT NUCMAP 
* If analyzing the dump interactively, use the instruction address in cee SME 


a WHERE subcommand to obtain the offset of the PSW address 
into-the load module. 


¢ If analyzing printed output, find the instruction address: 


— In dump output from the LIST or VERBEXIT SUMDUMP sub- 
command. Look for the CSECT name eye-catcher. IBM 
CSECT eye-catchers are generally followed by an assembly 
date and a product identifier or PTF level, such as JBB3313 or 
UY01234; most eye-catchers are at the beginning of a 
module, but some are at the end. 


— In amodule listed for the LPAMAP or VERBEXIT NUCMAP 
subcommand. 


Subtract the starting address of the CSECT from the instruction 
address to obtain the offset into the CSECT. 


9. Collect and analyze any other problem data recommended in the pro- 
cedure for an abend in the Basics of Problem Determination book. 


1-8 Component Diagnosis: Callable Service Requests LY28-1024-1 © Copyright IBM Corp. 1988, 1989 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


10. Report the problem to IBM, if assistance is needed or if the problem is Chapter 4, “Reporting a Problem 
new. Provide the following problem data: to IBM” 


Problem type: abend 

Search argument 

Dump formatted by IPCS, online or printed 

SDWAVRA keys, lengths, and contents 

Offset of the failing instruction into the module 

Accompanying messages: identifiers and texts 

SYS1.LOGREC report, if used 

Module name and level 

Name and level of the operating system(s) with a list of program 
temporary fixes (PTF) applied at the time of the problem and all 
installation modifications, exits, and products with other than 
Class A service 

Other problem data developed while using the Basics of Problem 
Determination book 
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Diagnosing a Return Code Due to a Problem in Cell Pool Services 


Use this procedure if the return code from the cell pool services part of callable 
service requests is on of the following. The codes indicate that cell pool services 
has found a problem in a data structure or in an associated service. The return 
codes are returned to the program issuing the call and appear in the caller’s param- 
eter list and register 15. 


| 

| 

| 

| 

| 

| 

| Return 
| Code 

| hex(dec) 
| 

| 

| 

| 

| 

| 


64 (100) 
68 (104) 
6C (108) 
70 (112) 
74 (116) 


| The return codes may be caused by one of the following conditions: 


| e The application is reusing storage that was originally given to a cell pool. 


| e The memory management service that the application is using encountered a 
| problem. 


| e There could be a problem with the code within the cell pool services part of the 
| component. : 
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1. Obtain an SVC dump from the requester of callable services Re 


2. Collect information about cell pool from the dump using the IPCS Chapter 2, “Collecting and Ana- 
CBSTAT and CBFORMAT subcommands. lyzing Problem Data for Callable 
Service Requests” on page 2-1 


3. Develop a search argument consisting of: Chapter 3, “Developing a Search 


Argument for Callable Service 


¢ Program identifier: PIDS/5752SCCSR ” 
Requests 


¢ Return code: PRCS/hhhhhhhh 


Use the search argument to search problem reporting data bases. If 
the search finds that the problem has been reported before, request 
the problem fix. If not, continue with the next step. 


4. Collect dump data. Using Dumps and Traces for 


Format the dump and print it or store it in a data set. Use the fol- requesting and printing dumps 


lowing IPCS subcommands, in this order. If using IPCS interactively, IPCS Command Reference for the 
respond yes to the IPCS message that asks if summary data can be subcommands 


used by dump access. | Chapter 2, “Collecting and Ana- 


lyzing Problem Data for Callable 
STATUS FAILDATA SYSTEM CPU REGISTERS DATA CONTENTION Service Requests” 
WORKSHEET . 
SUMMARY TCBERROR 
SUMMARY FORMAT 
VERBEXIT LOGDATA 
VERBEXIT SUMDUMP 
VERBEXIT TRACE 
VERBEXIT MTRACE 
CBSTAT addr STRUCTURE (CSRCPOOL) 
CBFORMAT addr STRUCTURE (CSRCPOOL) 
VERBEXIT SYMPTOM 


6. Report the problem to IBM, if assistance is needed or if the problem is 
new. Provide the following problem data: 


Problem type: return code 

The search argument 

Module name and level 

Name and level of the operating system(s) with a list of program 
temporary fixes (PTF) applied at the time of the problem and all 
installation modifications, exits, and products with other than 
Class A service 

Other problem data developed while using the Basics of Problem 
Determination book 
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Diagnosing a Return Code Due to a Problem in Data Windowing 
Services 


Use this procedure if the return and reason codes from the data windowing services 
part of callable service requests are the following. These code combinations indi- 
cate a problem in data windowing services. The return codes are returtied to the 
program issuing the call and appear in the caller’s parameter list and register 15. 
The reason codes are returned to the program issuing the call and anes inthe 
caller’s parameter list and register 0. 


Return Reason 
Code Codes 
hex(dec) (hex) 


4 (4) 00000125 
8 (8) 00000118, 00000119, 00000152 


1. Develop a search argument consisting of: Chapter 3, “Developing a Search 


- Program identifier: PIDS/5752SCCSR Aina ae ee ie 
¢ Return code: PRCS/hhhhhhhh q 
¢ Reason code: PRCS/hhhhhhhh 


Use the search argument to search problem reporting data bases. If 
the search finds that the problem has been reported before, request 
the problem fix. If not, continue with the next step. 


2. Collect and analyze any other problem data recommended in the pro- 
cedure for a return code in the Basics of Problem Determination book. 


3. Report the problem to IBM, if assistance is needed or if the problem is 
new. Provide the following problem data: 


¢ Problem type: return code 

¢ The search argument 

¢ Name and level of the operating system(s) with a list of program 
temporary fixes (PTF) applied at the time of the problem and all 
installation modifications, exits, and products with other than 
Class A service 
Other problem data developed while using the Basics of Problem 
Determination book 
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Chapter 2. Collecting and Analyzing Problem Data for 
Callable Service Requests 


This chapter contains information to help you collect and analyze data from a dump 
for a problem in the cell pool services part of callable service requests. 


Using the IPCS CBSTAT and CBFORMAT Subcommands to Obtain 
Cell Pool Services Data 


If a problem occurs, the program requesting the cell pool service requests a dump 
that includes cell pool data. This dump contains unformatted cell pool data. Use 
IPCS to format this data. For information about IPCS commands, see /PCS 
Command Reference, and for information about using IPCS, see /PCS User’s Guide. 


Formatted cell pool data can be obtained in one of the following ways: 
e Do the following: | 
1. Start an IPCS session. 
2. Select the COMMAND option from the IPCS PRIMARY OPTION MENU. 


3. Enter one of the following subcommands on the IPCS Subcommand Entry 
panel: | 


CBSTAT addr STRUCTURE (CSRCPOOL) 
CBFORMAT addr STRUCTURE(CSRCPOOL) 


where addr is the address of acell pool. The application supplied this area; 
obtain the address from the application. 


e AnIPCS application can exist and be used in conjunction with the application 
that originally requested the cell pool services. For example, an application can 
call cell pool services and, because of a problem, request an SVC dump. Later, 
after the dump is loaded onto a system for analysis, the IPCS application can 
collect and format information using CBSTAT and CBFORMAT. 
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Output from CBSTAT Subcommand 
If the address used in the CBSTAT command points to a valid CSRCPOOL and there 
are no errors, a sample of what you might see is: 


IPCS OUTPUT STREAM LINE 0 COLS 1 78 


COMMAND ===> SCROLL ===> CSR 


KRKAKEKEKKKKKEKKKKKKKKEKKKKKKKKKE TOP OF DATA KEKKKKEKKKKKKKKEKEKKKKEKKKKEKKKKKKKK 


STATUS FOR STRUCTURE(CSRCPOOL) AT 00006000 ASID(X'0021') 


Cell Pool - User name: POOL #4 


CSR10002I No errors were detected in CSRCPOOL data. 


KAKK KK KKK KK KKKKKKKKKKKKKKKKKKKE END OF DATA KAKKKKKKKKKKKKKKKKKKEKKKKKKKKKKKKKKS 


If the address used inthe CBSTAT command does not point to a valid CSRCPOOL, 
then a sample of what you might see is: | 


IPCS OUTPUT STREAM aan LINE © COLS 1 78 
COMMAND ===> | SCROLL ===> CSR 


KRKEKKKKKKKKRKKKKKKKKKKKKKRKEKRKEKK TOP OF DATA KHRKKKKKEKKEKKKKKKKKKKEKKRKRKKKEKKEKER 


STATUS FOR STRUCTURE(CSRCPOOL) AT 00006010 ASID(X'0021') 
Cell Pool 
CSR1OOO1I ASID(X'0021') 90006010 does not point to a cell pool anchor. 


Anchor: 00006010 
+0000 90000004 00006040 90000004 BOaR0000 | 
+0010 00000000 02000000 QE0000e0 BOOCR0N | 
+0020 00000000 90000000 HE000D00 00000000 | 
+0030 C3E2D9C3 D/C5C201 | CSRCPEB. 


KKEKKKKKKKKKKKKKKKKKKEKKKKKKKEKK END OF DATA AAKKKKKKKKKKKKKKKEKKKKKKKKKKKKKEKKK 


In the output, the content of what was thought to be a valid CSRCPOOL is displayed 
in hexadecimal and EBCDIC. 
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Output from CBFORMAT Subcommand 
If the address used in the CBFORMAT command points to a valid CSRCPOOL and 
there are no errors, then the cell pool information is displayed in a summary form: 


IPCS OUTPUT STREAM LINE 0 COLS 1 78 
COMMAND ===> SCROLL ===> CSR 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKK TOP OF DATA KAKEKKKKKKKKKKKEKKKKKKKKKKKKKKKKKKAKKK 


Cell Pool - User name: POOL #4 


Expected number of extents 
Number of extents found 
Active 
Inactive 
Not connected 
Error 


Cell Size 4 


Cells Number of cells Available cells 
Active extents 0 0 
Inactive extents 256 256 
Total — 256 | 256 


KKKEKKKKKKKKRKKKEKEKKERKKKKEKRKKKKK END OF DATA KKEKKKEKKKRKKKKKRKEKKKKKREKKKKKKKKKKKK 


If the address used in the CBFORMAT command does not point to a valid 
CSRCPOOL, then a sample of what you might see is: 


IPCS OUTPUT STREAM LINE 0 COLS 1 78 
COMMAND ===> | SCROLL ===> CSR 
KKAKKAK KKK IKK IKI KK AKERAAARKRK TOP OF DATA AXKAAAAKAAK AAR AK KARA IKK RAK IKK KK AIK 


Cell Pool 


CSR10001I ASID(X'0021') 00006010 does not point to a cell pool anchor. 


KKEKKKKKKKKKKRKKKKKKEKKEKKEKKEKKEKK END OF DATA KKEKKKKKEKKKKKEKKKKKKKKKERKKKKKKKKKKKK 
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Chapter 3. Developing a Search Argument for Callable 
Service Requests 


Search procedures and arguments are described in the Basics of Prohlem Determi- 
nation book. | 


The following table lists alphabetically the symptoms for search arguments for this 
component. For the symptoms for a particular problem, see the procedure for that 
problem in Chapter 1, “Diagnosing Problems in Callable Service Requests”. The 

symptoms in each procedure are listed in the order that provides the most efficient 


search. 
Free Format Symptom Structured Format 
Description Symptom 
Module name CCCCCCCC RIDS/cccccccc 


For example: CSRWVIEW For example: 


RIDS/CSRWVIEW 
PIDS/5752ccccc 


5752ccccce 


Program identifier 


For example: 
PIDS/5752SCCSR 


For example: 
9752SCCSR 


A @ 8 & BR mw 


Return code rchhhhhhhh PRCS/hnhhhhhh 


For example: rc00000008 For example: 
PRCS/00000008 


PRCS/hhhhhhhh 


hhhhhhhh 
For example: 0000011A 


Reason code 


For example: 
PRCS/0000011A 


AB/SOhhh 
For example: AB/SO00C4 


abendhhh 


System abend code 


For example: abend0C4 


Other search arguments developed while using the 
Basics of Problem Determination book 
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Chapter 4. Reporting a Problem to IBM 


The checklist in the following table identifies the data that IBM needs for a problem 
in callable service requests. Collect the data appropriate for the problem type 
before calling to report a problem. 


Problem type 


Search argument from Chapter 3, “Developing a 
Search Argument for Callable Service Requests” 


SVC or stand-alone dump formatted by IPCS, online or 
printed, including, if appropriate: 


¢ Output from CBSTAT and CBFORMAT subcom- 
mands 


Offset of the failing instruction into the module 


OAF 
SYS1.LOGREC report 
SDWAVRA keys, lengths, and contents 


Module name and level CSRWVIEW at PTF level UY00934 


Name and level of the operating system(s) with a list JBB3313 (MVS/System Product 3.1.3) at PUT tape 
of program temporary fixes (PTF) applied at the time level T8804 

of the problem and all installation modifications, exits, | 

and products with other than Class A service 


Other problem data developed while using the Basics 
of Problem Determination book 


LY28-1024-1 © Copyright IBM Corp. 1988, 1989 ‘Chapter 4. Reportinga Problem 4-1 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


4-2 Component Diagnosis: Callable Service Requests LY28-1024-1 © Copyright IBM Corp. 1988, 1989 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Chapter 5. Callable Service Requests Functions 


Callable service requests are callable interfaces that allow access to system Ser- 
vices by programs written in high level languages (HLL). The two callable service 
requests functions are: : 


e Data windowing services 
e Cell pool services 


Data Windowing Services 


Data windowing services are part of the callable service requests component. Data 
windowing services allow HLL applications to use the data-in-virtual system ser- 
vices via a standard CALL. In addition to supporting data-in-virtual, data windowing 
services use hiperspaces. 


A hiperspace is a range of up to 2 gigabytes of contiguous virtual storage. It does 
not require central storage backing; it is backed by expanded storage with the 
potential to spill into auxiliary storage. For further information on hiperspaces, see 
SPL: Application Development — Extended Addressability. 
Data windowing services provides the caller with the following features: 
* Temporary data objects - The caiier can specify that hiperspace storage wili be 
created for use as a data object. 


e New permanent data objects - The caller can specify that a new linear data set 
will be created for use as a permanent data object. 


¢ Dynamic allocation of existing data objects - Data windowing services dynam- 
ically allocate the data object to a system DDNAME. 


e Scroll area - The caller can specify that hiperspace storage is to be used as a 
scroll-area. A scroll area captures data without modifying a permanent object. 


Data Windowing Services Functions | 
The functions of data windowing services are: 


e Identify and Access - Allow an application program to define a data object and 
indicate if the object can be updated or only read by data windowing services. 


e Unaccess and Unidentify - Allow an application to cancel the identify and access 
request. 


e View Begin - Establishes an association (mapping) between all or part of the 
data object and a virtual storage area where the caller can view the object data. 


e View End - Removes the association established by View Begin. 


e Scrollout - Saves changes made to temporary objects, or to permanent objects if 
a scroll area was requested. Changes made to a permanent object with a scroll 
area can be saved without modifying the permanent object at that time. 


e Save - Writes changes to permanent data-in-virtual objects. 


® Refresh - Resets the View. Changes made to the data object since the last time 
it was saved are discarded. 
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A HLL application requests these functions by a CALL statement. 


For further information on window services, see Application Development Guide. 


Cell Pool Services 


| 
| Bit mapped cell pool services are part of the callable service requests component. 

| The callable services provided by cell pool can be called by an application program. 
| written in an HLL. 


| Cell pool services consist of service routines that manage user-supplied areas of 

| virtual storage as a cell pool. A cell pool contains a number of fixed-size elements 
| called cells and a control structure for cell pool management. Celi pool services 

| run as an extension to the application and have the same execution environment 

| and PSW key. Cell pool services also use any recovery environment set up by the 
| caller. 


| Cell Pool Services Functions 
| The functions of cell pool services are: 


| e Build - Formats a cell pool anchor data area for the cell pool. Each cell pool 
| must have an anchor. 


| e Expand - Formats a cell pool extent data area, connects additional caller- 
| acquired storage to the extent, and activates the extent. 


| ¢ Connect - Connects caller-acquired cell storage to an extent. 
| e Activate - Activates the cell storage for an extent. 
| e Deactivate - Deactivates a cell pool extent. 


| ¢ Disconnect - Disconnects an extent’s cell storage and makes it unavailable to 
| the cell pool manager. 


| e Get - Allocates a cell from the cell pool to the calling program. 
| e Free - Returns a previously allocated cell to a cell pool. 


| ® Query - Retrieves information about a cell, cell pool, or cell pool extent. 
| An application requests these functions by a CALL statement. 


| : For further information on cell pool, see Application Development Guide. 


Cell Pool Exits for IPCS 


| 

| Cell pool provides IPCS support to perform analysis and generate output that can be 
| used for problem determination. See Chapter 2, “Collecting and Analyzing Problem 
| Data for Callable Service Requests” on page 2-1 for information about |PCS for cell 
| pool. 
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| Callable Service Requests Modules 


| The cell pool services modules are named CSRCPccc. 


| The data windowing services modules are named CSRccccc. 
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Index 


A 


abend unexpected by cell pool services problem 
diagnosing 1-4 
identifying 1-1 


abend unexpected by data windowing services problem 


diagnosing 1-7 
identifying 1-1 
abend 019 problem 
identifying 1-1 
abend 08B problem 
identifying 1-1 
abnormal termination 
See abend xxx for the particular code 
analyzing problem data 
in callable service requests 2-1 


Cc 


callable service requests 
function of 5-1 
problem diagnosisin_ 1-1 
CBFORMAT subcommand 
output 2-1 
CBSTAT subcommand 
output 2-1 
cell pool services user problem 
identifying 1-2 
collecting problem data 
in callable service requests 2-1 
CSReccce 5-3 
CSRCPccc 5-3 


D 
data 
for problems 
See problem data 
data windowing services user problem 
identifying 1-3 
diagnosing problem 
in callable service requests 1-1 


F 


function 
provided by callable service requests 5-1 


identifying problem 
See problem type 
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module 
in problem data 4-1 
name of, for callable service requests 5-3 


O 


operating system. 
name 
in problem data 4-1 


p 


problem data 


See a/so analyzing problem data, collecting problem 


data 
for callable service requests 4-1 
problem type 
identifying in callable service services 1-1 


R 


return code from cell pool services problem 
diagnosing 1-19 
identifying 1-1, 1-2 

return code from data windowing services problem 
diagnosing 1-12 
identifying 1-2 


S 


search argument 
symptom for callable service requests 3-1 
stand-alone dump 
in problem data 4-1 
SVC dump 
in problem data 4-1 
SVC 99 problem 
identifying 1-3 
symptom 
See a/so search argument 
abend code _ 3-1 
callable service requests 3-1 
for problem in callable service requests 1-1 
module name 3-1 
program identifier 3-1 
return or reason code 3-1 
SYSMDUMP ABEND dump 
in problem data 41 
system completion code 
See abend xxx for the particular code 
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Numerics 
000 to FFF 
See abend xxx for the particular code 
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